home *** CD-ROM | disk | FTP | other *** search
/ Risc World 5 / Risc World 5.iso / SOFTWARE / Issue5 / PD / DIRSYNC / LegalStuff / ccres / Data / Help < prev    next >
Text File  |  2003-12-09  |  3KB  |  90 lines
  1. Purpose
  2. ~~~~~~~
  3. !CCres converts Toolbox Resource files (type FAE, RESF v1.00 or v1.01) and
  4. Wimp Template files (type &FEC) to and from text format.
  5.  
  6. Wimp application
  7. ~~~~~~~~~~~~~~~~
  8. Run !CCres by double clicking the icon. To convert either file type, simply
  9. drag the file to the Iconbar, then drag the 'Save As' icon to a filer viewer.
  10.  
  11. Command line
  12. ~~~~~~~~~~~~
  13. !CCres can be run without starting it as a wimp application by specifying
  14. both the from and to file names on the command line, eg
  15.  
  16. *Run !CCres <infile> <outfile>
  17.  
  18. Compatibility
  19. ~~~~~~~~~~~~~
  20. CCres is 26/32bit compatible. It is now linked with the StubsG library, so
  21. should no longer require the updated System files from Castle.
  22.  
  23. CCres can be run on RISC OS 3.10 or later using the latest Toolbox modules
  24. available from the RISC OS Web site
  25. <URL:http://support.riscos.com/Support/Updates/>
  26.  
  27. Text file format
  28. ~~~~~~~~~~~~~~~~
  29. Uses a simple C-like layout based on the equivalent OSLib header definitions.
  30. Some entry names have been changed slightly to avoid duplication and ambiguity
  31. where appropriate.
  32.  
  33. String entries may be enclosed in quotes to ensure that trailing spaces are
  34. kept intact. CCres encloses strings in quotes by default, but they are not
  35. obligatory.
  36.  
  37. The values for bbox, coord and cmp fields can be in the form of simple
  38. mathematical expressions. The symbols ()+-*/ are supported, allowing
  39. constructs like (100+50)/2 etc
  40.  
  41. Some possible uses
  42. ~~~~~~~~~~~~~~~~~~
  43. * Gadget renumbering
  44. * Aligning and resizing gadgets
  45. * Add or review interactive help
  46. * Simplifies language translation
  47. * File compare of text format res files gives useful output!
  48.  
  49. NOTES
  50. ~~~~~
  51. Res files created by !CCres may not be identical to !ResEd files:-
  52.   * Relocation information is stored 'sequentially' (ie ascending address
  53.     offset) by !CCres, but *not always* by !ResEd
  54.   * !ResEd sometimes saves superfluous information, which is stripped out by
  55.     !CCres (eg FileInfo, - data_and_time and file_size)
  56.   * !ResEd saves button gadget validation_limit as 1 even if no validation
  57.     string supplied. !CCres sets it to zero
  58.  
  59. Template files created by !CCres may not be identical to !FormEd files:-
  60.   * When a string is truncated in FormEd, text beyond the new terminator is
  61.     sometimes still saved in the file. !CCres ignores any text after the
  62.     terminating charcter.
  63.   
  64. For these reasons a simple 'binary compare' of 'before and after' files will
  65. almost always say they're different.
  66.  
  67. Author
  68. ~~~~~~
  69. Dave Appleby wrote all the code up to v1.08 (included).  Versions after that
  70. (v1.09 and later) are maintained by John Tytgat / BASS.
  71.  
  72. License
  73. ~~~~~~~
  74. !CCres version before v1.09 were released as FreeWare. It must only be
  75. distributed in its original form and there must be no charge for it
  76. (except possibly for covering media costs).
  77.  
  78. From version 1.09 onwards, the CCres license is the
  79. GNU General Public License of which you find a copy as !CCres.COPYING.
  80.  
  81. Note that this software is provided in good faith and no guarantee is
  82. provided for suitability or reliably. The authors shall not be held
  83. responsible for any loss of data, or other problems arising from the use
  84. of this program.
  85.  
  86. Bugs, Updates and Suggestions
  87. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  88. Updates available from: <URL:http://www.bass-software.com/ccres/>
  89. Bug reports and suggestions to: <URL:mailto:ccres@bass-software.com>
  90.